home *** CD-ROM | disk | FTP | other *** search
/ The Utilities Experience / The Utilities Experience - Volume 1.iso / software / graphics / gfx_card / cybershow / cybershow.readme < prev    next >
Text File  |  1995-12-21  |  39KB  |  771 lines
  1. CyberShow Professional Version 5.0 (c) by Helmut Hoffmann 1995
  2. ======================
  3.  
  4. This is an universal shareware picture viewer/slideshow/presentation
  5. program (incl. PhotoCD support, transition effects, zooming ...) and
  6. converter for all Amigas with OS3.0 and higher which can
  7.  
  8. * display images in TrueColor/HighColor in Cybergraphic windows or screens on
  9.   Workbench, custom screens or public screens with at least 15Bit color depths
  10.   including transition effects for slideshow or presentation windows
  11.  
  12. * display images in reduced color (upto 256 colors) on any WB screen, custom
  13.   screen or public screen, including AGA, ECS, OCS and usually WB-Emu graphic
  14.   board screens as well (e.g. EGS-Emu, CyberGfx-Emu, ...)
  15.  
  16. It has many special features which make it a flexible, fast and comfortable
  17. multi-purpose tool.
  18.  
  19. +-------------------------------------------------------------------+
  20. | New: Now available *** HHsFastUniversalGioModules ***             |
  21. |                    *** HHsFastImageFXModules ***                  |
  22. | Use all the speed and format flexibility of CyberShow             |
  23. | loading functions (without JPeg) for Photogenics or ImageFX!      |
  24. | Even DataTypes can now be used with Photogenics/ImageFX!          |
  25. | Add-on price: 8US$ or 10DM each if you also order another program |
  26. | Special price for registered CyberShow users: 13US$ or 15DM each  |
  27. +-------------------------------------------------------------------+
  28.  
  29. New in V5.0: + Fast zooming functions to zoom in (+) and out (-) (4:1 to 1:4) for
  30.            magnification or reduced viewing
  31.          + Support for new file formats: binary-EPS bitmaps RGB/CMYK and
  32.            TBCPlus frames (maybe also fields; this is untested)
  33.          + Included german documentation
  34. New in V4.3: + Configurable delay time for automatic picture presentation
  35.         (slideshow etc.) incl. endless-loop feature
  36. New in V4.2: + New fascinating slideshow/presentation effects...
  37. New in V4.1: + Support for 15/16Bit Targa files (compressed and uncompressed)
  38. New in V4.0: + Slideshow mode to display pictures without window frames
  39.            (useful for video presentations e.g. with black screen background)
  40.              + Presentation mode to display pictures in a window of fixed size
  41.            (useful e.g. for presentations on the Workbench where you don't
  42.         want the window size to change with each picture)
  43.              + Introduction of transition effects for Slideshow and Presentation
  44.                Window mode
  45.              + IgnoreError parameter to skip unreadable files quietly
  46.                (useful if you e.g. have many non-picture files like .readmes on a
  47.         CD you want to scan for pictures without getting lots of errors)
  48. New in V3.x: + Multiple file/pattern/directory parameters (CLI,WB,filerequester)
  49.          + Selectable options (CLI parameter, WB tooltypes)
  50.          + Support of separate screens
  51. (see version history for details or earlier versions...)
  52.  
  53. Supported picture file formats for loading:
  54.  
  55. 1) IFF-ILBM (all standard formats 1 to 8Bit, EHB, HAM6, HAM8, 24Bit)
  56. 2) PhotoCD (Base format 768x512 or 512x768 (portrait); linear 24Bit RGB)
  57. 3) JPeg (color and greyscale)
  58. 4) PPM/PGM/PBM (P1&P4 b&w, P5 grey, P6 color)
  59. 5) QRT (also known as dump format by PD raytracers as POV-Ray)
  60. 6) Targa (RLE compr.&uncompr. 1/8/15/16/24/32Bit; incl. interleaved)
  61. 7) PCX (compr.&uncompr. EGA1-4Bit, VGA 8Bit grey/Colormap and 24Bit)
  62. 8) BMP (uncompr. 24Bit RGB,1Bit,4Bit or 8Bit Colormap; RLE compressed 8Bit,1Bit)
  63. 9) TIF (packbit-compr./uncompr. Motorola formats 24Bit RGB, 1-8Bit grey/Colormap)
  64. 10) EGS7.x window icons
  65. 11) DEEP (compr.&uncompr. IFF-DEEP 24Bit and 32Bit formats)
  66. 12) YUV (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  67. 13) VLAB raw (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  68. 14) RGB (IFF-RGB: RGB8 and RGBN compressed; RGB5 uncompressed)
  69. 15) HHsYUVSq sequence format (sequential or random access)
  70. 16) IFF-PBM (DPII) format
  71. 17) ACBM (IFF-ACBM: 1 to 8Bit, EHB, HAM6, HAM8)
  72. 18) FBM (8Bit grey/Colormap and 24Bit)
  73. 19) Sun raster (uncompressed formats for 1Bit, 8Bit grey/ColorMap and 24Bit)
  74. 20) MacPaint (b&w compressed 1Bit format; datafork only)
  75. 21) HHsXRL formats (1-8Bit ColorMap incl. HAM6/8, 8Bit grey, 24Bit RGB compressed)
  76. 22) binary-EPS bitmaps (RGB and CMYK; this function is experimental)
  77. 23) TBCPlus frames (maybe also fields; this is untested)
  78.  
  79. and all picture DataType formats (OS3.0 and up) and animation DataType
  80. formats (OS3.1 and up).
  81.  
  82. -> Important! If you have any difficulties viewing certain picture types
  83. -> (e.g. PCX, PhotoCD, DataTypes, JPeg etc.) directly from CD-ROMs (while viewing
  84. -> the same pictures copied to disk works), you have encountered a CD-ROM file
  85. -> system problem. I have heard of difficulties with several third party file
  86. -> systems. I recommend to use only one of the following CD-ROM file systems:
  87. ->    1) Original AmigaDOS OS3.1 CD-ROM file system
  88. -> or 2) AmiCD-File System V1.15 or higher (older versions are probably NOT usable)
  89.  
  90. For animation formats (HHsYUVSq and animation datatypes) the first frame is shown
  91. (for playback of HHsYUVSq animations you can use my freeware program CyberTVPlayer).
  92.  
  93. Please note: The GIF format is not internally supported for legal reasons, but
  94. due to the DataType support GIF loading should be possible if you have a
  95. suitable DataType (with a fast GIF DataType loading is usually still faster
  96. than with many other viewers which directly support GIF!).
  97.  
  98. Supported picture file formats for saving:
  99.  
  100. 1) IFF-ILBM 24Bit (compressed and uncompressed)
  101. 2) IFF-DEEP 24Bit (uncompressed)
  102.    This format is used e.g. by TVPaint, XiPaint or Photogenics
  103. 3) JPeg (variable compression rates)
  104. 4) PPM-P6
  105.    This format is used by the PBM image processing software
  106. 5) QRT
  107. 6) Targa 24Bit (compressed and uncompressed)
  108. 7) HHsXRL TC24 format (compressed lossless and lossy)
  109.    This format is esp. designed for raytracing pictures, which should be
  110.    compressed lossless or with nearly invisible losses. Compression is usually
  111.    better than IFF-ILBM or Targa compression.
  112.  
  113. Highlights of CyberShow: Why should you use this viewer
  114.  
  115. + flexible presentation of your pictures in windows or on screens incl.
  116.   slide show function or window presentation mode with transition effects.
  117.   A selectable delay time allows automatic presentations...
  118.  
  119. + Fast zooming (magnification upto 1:4 and reduction upto 4:1; use + to zoom
  120.   in and - to zoom out; * to go to standard size) and fast scrolling functions
  121.   (cursor keys or scrollbars)
  122.  
  123. + All loading functions (except JPeg: This software is based in part on the work
  124.   of the independent JPeg Group) have been written in Assembler and optimised for
  125.   extremely high speed. Loading will usually be upto 5 times faster than with
  126.   comparable viewers... An exception to this is the JPeg format, which is
  127.   written in C and based on the usual code, so that it will be about the same
  128.   speed as other viewers.
  129.  
  130. + Automatic preloading: The next picture is loaded while you view the current
  131.   picture; you can now also scroll or zoom the picture or use other functions
  132.   during preloading of the next picture; this reduces waiting time to a minimum
  133.  
  134. + Supports true color viewing on Cybergraphic public screens (or custom screen)
  135.   of at least 15Bit color depths
  136.  
  137. + Supports reduced color viewing on screens with 2 to 256 colors, including
  138.   most kind of WB emulations on graphic boards. A special color selection
  139.   scheme is used for good quality and good speed.
  140.  
  141. + Support of nearly all commonly used image formats (incl. PhotoCD) and
  142.   additional DataTypes for even more formats
  143.  
  144. + Can view single files, group of files (supporting patterns) and
  145.   even directory trees (automatic search of subdirectories); multiple
  146.   picture arguments can be passed by CLI, Workbench or selected with file
  147.   requester. Images will be shown in alphabetical order (ordered by complete
  148.   path name).
  149.  
  150. + Optional downscaled loading for faster access and less memory usage
  151.   (selectbale as CLI parameter, WB Tooltype or by menu function)
  152.  
  153. + Can go back to previous images as well
  154.  
  155. + Information window for picture can be opened including name, dimensions,
  156.   file type, file size, file comment and number of frames (for animations)
  157.  
  158. + Fast direct transfer of images to famous image processing and painting
  159.   programs (currently ImageFX, XiPaint and ArtEffect/PicoPainter are supported;
  160.   transfers to other programs could be included if more developers/dealers
  161.   would support me and more programs would have sufficient interfaces)
  162.  
  163. + Save function to convert pictures into some 24Bit file formats (JPeg, IFF, ...)
  164.  
  165. (More to come if enough users register: Possible future expansions e.g.
  166.  + more spectacular transition effects for slideshow/presentation mode
  167.  + support for more file formats)
  168.  
  169. Using instructions
  170. ==================
  171.  
  172. Configuration: Usually CyberShow will show the pictures in windows directly on
  173.   the default public screen (usually the Workbench). To make use of other
  174.   screens, private screens or to present the pictures as SlideShow etc,
  175.   you can select options as CLI parameter or by Workbench Tooltypes.
  176.   A screenmode or public screen name can also be specified by the
  177.   environment variable "CyberShowScreen":
  178.  
  179.   a) Custom Screen: If you want a screen to be opened for CyberShow you should
  180.      set an environment variable with the screenmode, e.g.:
  181.      SETENV CyberShowScreen "NTSC:HighRes Interlace"
  182.      You can specify all kinds of screenmodes for Amiga screens, emulation
  183.      screens of graphic boards and TrueColor/HighColor screens for Cybergraphics.
  184.      In any case the screen will be opened with the max. depth which is available
  185.      for that mode. Please note that the screenmode name is case sensitive!
  186.      Take a look at the Prefs/Screenmode program's list of screenmode names
  187.      to see what is available. If you specify an unknown screenmode name or
  188.      the specified screenmode can't be used for some reason the program will
  189.      use the default public screen (after an information requester).
  190.  
  191.      Alternatively you can specify a CLI parameter "Screenmode": e.g.
  192.       CyberShow Screenmode "NTSC:HighRes Interlace"
  193.      This parameter will override the ENV: variable as well as a
  194.      PublicScreen parameter.
  195.      This is also available as tooltype for WB start (e.g.
  196.      Screenmode=NTSC:HighRes).
  197.  
  198.   b) Named Public Screens: If you want to make CyberShow use a non-default
  199.      Public Screen, you can also specify this with the ENV: variable, e.g.:
  200.      SETENV CyberShowScreen "*CoolScreen"
  201.      To distinguish between a screenmode and a public screen name the *
  202.      character has to be specified before the screen name. To find out the
  203.      public screen name of your applications, look into their manuals! The
  204.      screen title of the public screens is often NOT the public screen name.
  205.      If the named public screen can't be used (if it is not found or private)
  206.      then the default public screen is used (after an information requester).
  207.  
  208.      Alternatively you can specify a CLI parameter "PublicScreen": e.g.
  209.       CyberShow PublicScreen "CoolScreen"
  210.      This parameter will override the ENV: variable. Please note that the *
  211.      has not to be specified for the CLI parameter. If you also specify a
  212.      Screenmode parameter, the PublicScreen parameter will be ignored.
  213.      This is also available as tooltype for WB start (e.g.
  214.      PublicScreen=CoolScreen).
  215.  
  216.   To save the screenmode or name specification for automatic use after booting,
  217.   just copy it from ENV: to ENVARC: (or use the WB Tooltype).
  218.   If you want to use the program on the default public screen again, just
  219.   SETENV CyberShowScreen "" or delete the variable from ENV: or from ENVARC:
  220.   for permanent effect (or delete the Tooltype).
  221.  
  222. Parameters: CyberShow now accepts multiple picture/path/pattern and
  223.   configuration parameters both from Workbench and CLI.
  224.  
  225.   a) Workbench usage: To specify pictures, you can multi-select one or several
  226.      pictures or even drawers by holding shift and selecting with the mouse
  227.      before double clicking.
  228.  
  229.      Another method is to make icons for the pictures and specify "CyberShow"
  230.      complete with it's path as default tool.
  231.  
  232.      Other options can be specified as tooltypes in the icon for WB start.
  233.      The options are similair to the CLI options. Take a look at the icon
  234.      to see the available parameters which are enclosed in parentheses to
  235.      make them inactive.
  236.        DefaultPath=path        Provide default path for path/pattern/file
  237.                 requester after startup or for save requester
  238.        Downscale=number        Select downscaling with factor 1:number
  239.                 (number range 1 to 16 supported in increments of 1)
  240.        NonRecursive        Switch off recursive subdirectory search
  241.        Screenmode=name        Select screenmode name for private screen
  242.                 (Overrides ENV:CyberShowScreen)
  243.        PublicScreen=name    Select named public screen
  244.                 (Overrides ENV:CyberShowScreen)
  245.        Icons            Do not ignore .info files. This is only useful if
  246.                 you have some Icon-Datatype and want to take a look
  247.                 at the icons of files. By default, .info files are
  248.                 now completely ignored. Please note that in
  249.                 addition to this option you might have to remove
  250.                 the ~(#?.info) pattern from the file requester if
  251.                 this is used.
  252.        Request            Show file/path/pattern requester after
  253.                 displaying all files
  254.        PresentWindow        Leave window size unchanged between pictures;
  255.                 window will open at screen size; smaller pictures
  256.                 are shown centered in the window; you can still
  257.                 resize the window manually. This presentation mode
  258.                 supports transition effects which are selected
  259.                 as default for TrueColor/HighColor windows
  260.                 (use Effects or NoEffects to manually control this)
  261.        SlideShow        Show pictures on screen (no window borders); this
  262.                 works best if you select your own Screenmode. On
  263.                 Workbench or Public screens you will still have
  264.                 a depth arrangement bar on default (you can instead
  265.                 select a backdrop window with another option).
  266.                 As there are no scrollbars, you can only scroll
  267.                 with the cursor keys in SlideShow mode. The usual
  268.                 menue functions are still available.
  269.                 The slideshow mode supports transition effects
  270.                 which are selected as default on TrueColor/HighColor
  271.                 screens    (use Effects or NoEffects to override)
  272.        BackDrop            Backdrop window for SlideShow on WB or Public Screens
  273.        Black            For small pictures fill unused screen or
  274.                 window areas with the foreground pen (usual
  275.                 black) instead of background (usual grey); in
  276.                 SlideShow mode on private screens black is
  277.                 always used and even specifed as background to
  278.                 make presentations better e.g. for Video recording
  279.        Effects            Select transition effects for window presentation
  280.                 or slideshow (effects are selected by default for
  281.                 TrueColor/HighColor screens only; use this option
  282.                 to get effects also on 2 to 256 color screens)
  283.        NoEffects        Disable transition effects; if you use this option
  284.                 together with the Effects option, the effects will
  285.                 actially be disabled, but the usual palette locking
  286.                 for 2 to 256 color screens will remain active
  287.        Delay=number        Automatically go to next picture after specified
  288.                 number of seconds (only available in registered
  289.                 Professional version)
  290.        Loop            Start with first picture again after showing last
  291.                 (useful in conjunction with Delay for automatic
  292.                  presentation at shows etc.)
  293.        IgnoreErrors        Do not show requesters for unreadable files;
  294.                 they will instead be quietly ignored
  295.        (Please note: SlideShow, presentation windows and delay are not available
  296.         in the CyberShow-Light version!)
  297.  
  298.   b) CLI usage: You can specify multiple pathes/pictures/patterns in the CLI
  299.      command line, e.g.:
  300.       CyberShow ram:#?.jpg tmp:#?.iff "CD1:Photo_CD/Images"
  301.      Picture parameters can be included in " for better compatibility.
  302.      This should work with directory utilites as well (I checked it with DirOpus
  303.      4.12A+: E.g. specify CyberShow {F} as DOS command for your CyberShow button).
  304.      There are many other parameters available as command line options, which are
  305.      usually identical to the Workbench ToolTypes. Type CyberShow ? to get a list
  306.      of parameters. Here are the additional parameters (incl. abbreviations):
  307.     DS=Downscale (number)    -> see WB tooltypes above
  308.     NR=NonRecursive        -> see WB tooltypes above
  309.     SM=Screenmode (name)    -> see WB tooltypes above
  310.     PS=PublicScreen (name)    -> see WB tooltypes above
  311.     Icons            -> see WB tooltypes above
  312.     Request            -> see WB tooltypes above
  313.     PW=PresentWindow    -> see WB tooltypes above
  314.     SL=SlideShow        -> see WB tooltypes above
  315.     BD=BackDrop        -> see WB tooltypes above
  316.     Black            -> see WB tooltypes above
  317.     Effects            -> see WB tooltypes above
  318.     NoEffects        -> see WB tooltypes above
  319.     Delay (number)        -> see WB tooltypes above
  320.     Loop            -> see WB tooltypes above
  321.     IE=IgnoreErrors        -> see WB tooltypes above
  322.  
  323. If you just start CyberShow without any picture parameters, a file/path/pattern
  324. requester appears. With this you can specify a directory (path) with an optional
  325. pattern or select one or multiple pictures (by holding shift during the selection).
  326. You can select a new file/path/pattern by using the "New Directory" menu entry
  327. at a later time (it will be shown automatically after displaying all files
  328. if you select the Request option).
  329.  
  330. In any case subdirectories will be searched automatically if you don't restrict
  331. searching by a pattern to one directory or use the NonRecursive option.
  332.  
  333. Default is to load pictures in full size. With the "Scaled-Loading" menue
  334. or Downscale option you can select to load all pictures in reduced size.
  335. For many file formats this downscaled loading will be significantly
  336. faster. Please note that the pictures will be in small form in memory, thus
  337. save or transfer operations will save or transfer the images in small form.
  338. This is different from the zooming functions. If you load a picture
  339. in normal size you can zoom out to get it in reduced size as well, but
  340. then the image remains in original resolution in memory.
  341.  
  342. To show pictures as slideshow instead of windows, it is best to specify
  343. a screenmode as well: E.g.
  344.   cybershow #?.jpg SlideShow ScreenMode "PICCOLOSD64:800x600x16M"
  345. You can also use the slideshow as backdrop e.g. on the WB screen.
  346. SlideShows and PresentWindow presentations will by default use transition
  347. effects on TrueColor/HighColor screens. You can switch them off with
  348. the NoEffects option or select them with Effects for palette oriented
  349. screens. Please note that effects on palette oriented screens can
  350. be quite slow (due to this fact some effects are only available on
  351. TrueColor/HighColor screens; while zooming is active, some effects are
  352. also disabled for speed reasons) and that the palette will be locked for
  353. all pictures. This can lead to reduced displaying quality if you have
  354. many pictures with different colors. On TrueColor/HighColor screens such
  355. problems can not occur. For automatic presentations you can now specify
  356. a delay time after which the next picture is selected automatically and
  357. a loop function for endless presentations. You still have full manual
  358. control with Menu functions or keys (use Esc or Quit to exit).
  359.  
  360. To advance to the next picture use the "Next Picture" menu entry
  361. (Shortcut Amiga N), press the space bar or press the close button of the
  362. picture window (the next picture will be selected automatically if you
  363. have specified a number of seconds as a delay time). During displaying the
  364. next picture will already be loaded. You can now scroll or resize the window
  365. or select another function while the next picture is preloaded (due to
  366. technical restrictions of some file formats this is partially not available
  367. if pictures are not stored line by line, e.g. FBM24, ACBM, DataTypes, vertical
  368. PCD images, YUV, VLB, HHsYUVSq; during the color conversion phase you can
  369. still scroll and this phase is often longer than the loading time unless
  370. you load from floppy disk).
  371.  
  372. Scrolling: Scrolling can be performed with cursor keys or the scroll bars
  373.  (scroll bars are not available in slideshow mode).
  374.  
  375. Zooming: Since V5.0 you can zoom in and out to magnify or reduce the
  376.  picture; to zoom in press the + key (max. magnification 1:4); to zoom
  377.  out press the - key (max. reduction 4:1); to go back to standard viewing
  378.  (1:1) press the * key. Please note that reduced viewing is different
  379.  from downscaled loading; if you load a picture downscaled, it is kept
  380.  in memory in reduced size and transfers or saves will be in reduced
  381.  size as well. If you just zoom out to reduce a picture, it remains
  382.  in memory in it's full resolution. The zoom stage will be kept even
  383.  if you change to the next picture.
  384.  Zooming is not available in CyberShow-Light version!
  385.  
  386. You can also go back to previous pictures with the "Previous Picture"
  387. menu entry (Shortcut Amiga P) or by pressing the backspace key.
  388.  
  389. If you try to select the next picture (or previous picture) before
  390. automatic preloading has finished, the window title will inform you about
  391. the already loaded part of the picture (in percent).
  392.  
  393. For the currently displayed picture you can get an information requester
  394. by selecting the "Picture Info" menu item (Shortcut Amiga I). It includes
  395. the name, dimensions, file format, file size, file comment and number of
  396. frames (for animations). The file format string often includes the color
  397. depths or other variation informations as well. For pictures loaded with
  398. any DataType, the file type is "DTxx" with xx being the color depth.
  399. For animations loaded with DataType the file type is "DHxx".
  400.  
  401. You can quit the program with the "Quit" menu item or by pressing the Esc
  402. key in the picture window (or screen), by pressing Ctrl-C in the CLI or
  403. sending a Ctrl-C signal to the task.
  404.  
  405. The "About" menu function gives an information requester (which includes
  406. the personal registration information if you are a registered user with
  407. a correctly installed keyfile).
  408.  
  409. Fast direct transfer and saving/conversion (not available in demo version):
  410.  
  411. You can directly transfer the image in full 24Bit quality very fast to
  412. important image processing and painting programs (see transfer menu).
  413. Currently supported applications: ImageFX, XiPaint and ArtEffect/PicoPainter
  414. Unfortunately Photogenics seems to currently have no suitable port to
  415. allow such transfers (at least upto V1.2). I hope this will change in
  416. the future.
  417.  
  418. Transfers should at least be possible to ImageFX 1.5/1.6, ImageFX 2.x,
  419. EGS-ImageFX, XiPaint 3.x, all versions of ArtEffect and PicoPainter 1.3.
  420. For ArtEffect/PicoPainter you can transfer the image into a picture
  421. project window or into a brush.
  422.  
  423. Please note that pictures will always be transferred in their loaded
  424. size. If you have selected the downscaled loading, the pictures will
  425. be transferred in small form.
  426.  
  427. The same restrictions apply to the save functions which can be used to
  428. convert the currently loaded image into one of several formats (see
  429. above for list of supported save formats). All pictures are saved as
  430. 24Bit images. This is not dependent on the screenmode. The size which
  431. has been used for loading will be the size in which it is saved. For
  432. JPeg saving you can select the quality between 50% and 95% in 5% steps
  433. with a sub menu.
  434.  
  435. Important: Please read the following
  436. ------------------------------------
  437.  
  438. -> Problems with loading specific file formats? <-
  439.  
  440. If you have difficulties viewing a picture in one of the supported
  441. file formats (or DataTypes) and you are sure that you have enough
  442. memory left, check the following:
  443.  
  444. a) File systems: Some PD/ShareWare/Commercial add-on or replacement
  445.    file systems (esp. CD-ROM file systems!) are buggy (e.g. they do
  446.    not support some rarely used DOS functions properly). Try to copy
  447.    the picture to a standard device (e.g. RAM:) and to view it from
  448.    there. If this works, you know that your specific file system is
  449.    buggy. I found the following file systems to be usable:
  450.    1) Original AmigaDOS OS3.1 CD-ROM file system
  451.    2) AmiCD-File System V1.15 or higher (older versions are probably NOT usable)
  452.    I recommend to only use one of thoose CD-ROM file systems.
  453.  
  454. b) DataTypes: Some DataTypes are instable and can crash on certain
  455.    pictures with odd dimensions or incomplete pictures. I have no
  456.    influence on this. If you have difficulties with certain DataTypes,
  457.    look out for newer versions.
  458.  
  459. Requirements
  460. ============
  461.  
  462. Any Amiga with
  463.  
  464. + OS3.0 or higher
  465. + some memory (about 4MByte Fast-RAM should be enough for normal use)
  466.  
  467. For displaying in TrueColor/HighColor quality you also need
  468.  
  469. + cybergraphics.library V40 or higher and a suitable graphic board
  470.   (Cybergraphics is a Workbench emulation/True color software extension
  471.    which is usable in conjunction with several graphic boards as the
  472.    Cybervision, Piccolo, SD64, Picasso, Retina-BLTZ3, Spectrum, Domino.
  473.    It is Copyright by Thomas Sontowski and Frank Mariak.)
  474.  
  475. Shareware modalities
  476. ====================
  477.  
  478. The unregistered demo version of CyberShow has an important restriction:
  479.  
  480. All pictures will be shown in greyscale only in the demo version!!!
  481.  
  482. Anyway, I have designed the loading functions so that the speed is the
  483. same as with color loading so that you can check the real speed of my
  484. fast loading functions, but please note: on screens with less than
  485. 15Bit color depths the displaying speed of the greyscale pictures could
  486. be higher than that of color pictures due to the fact that the color pen
  487. allocation is different. I have no influence on this; to see the real
  488. speed, try it on HiColor/TrueColor screens (if you have Cybergraphics),
  489. as no color pens are needed and it makes no difference if a greyscale
  490. or true color image is displayed. If you want to see how the color
  491. allocation works with 2 to 256 colors, take a look at CyberTVPlayer,
  492. my freeware animation player for HHsYUVSq sequences (a sample sequence
  493. is included in the CyberTVPlayer archive). CyberTVPlayer uses the same
  494. color reducing functions as CyberShow.
  495.  
  496. Some other functions are also not available in the demo version (e.g.
  497. fast direct transfer functions and save functions).
  498.  
  499. Currently you can choose between two levels of registration:
  500.  
  501. a) CyberShow Professional (incl. SlideShow/Presentation/Zooming etc.)
  502.  
  503.    Shareware fee 30DM (in europe) or 25US$ (outside europe); other
  504.    currencies possible (see registration form)
  505.  
  506. b) CyberShow Light (without SlideShow/Presentation/Zooming etc.)
  507.  
  508.    Shareware fee 20DM (in europe) or 18US$ (outside europe); other
  509.    currencies possible (see registration form)
  510.  
  511.    Please note that the CyberShow-Light registration is only
  512.    available upto 31st October 1995 and if at all possible you should
  513.    only register for the Professional version to encourage further
  514.    development of high quality shareware products. New functions in
  515.    future versions of CyberShow might be available to Professional users
  516.    only as well.
  517.  
  518. To register send the filled in and signed registration form (included
  519. in this archive) to my address together with the money as banknotes,
  520. a cheque or international postal money order:
  521.  
  522. My address:             Helmut Hoffmann
  523.             Rubensstrasse 4
  524.             D-41063 Moenchengladbach
  525.  
  526.             Germany
  527.  
  528. Users in germany can also transfer money to my account (No bank transfers
  529. from outside germany!!).
  530.  
  531. You can currently contact me by EMail (no registrations by EMail!):
  532.  
  533.         hhoff@pool.informatik.rwth-aachen.de
  534.  
  535. After registration you will receive a keyfile and the latest version of
  536. this program. The keyfile will enable you to use future demo versions of
  537. this program as full version. The processing of your order can take
  538. some time. Usually it will be very fast (only a few days), but under raw
  539. circumstances it could take some weeks.
  540.  
  541. Registered users might get another advantage: If I decide to port my
  542. picture management software EGSPhotoAlbum for Cybergraphics and standard
  543. Amigas, registered CyberShow users can register for a lower price.
  544. The fast loading functions of CyberShow are the same as thoose in
  545. EGSPhotoAlbum Professional 5.x.
  546.  
  547. Special note for Photogenics users: In addition to CyberShow you can order
  548. my FastUniversalGioModule for a small add-on fee (see registration form).
  549. The loader module is based on the same functions as CyberShow (only
  550. JPeg is missing as this did not bring any significant speed advantage).
  551.  
  552. Special note for ImageFX users: In addition to CyberShow you can order
  553. my FastImageFXModules for a small add-on fee (see registration form).
  554. The loader module is based on the same functions as CyberShow (only
  555. JPeg is missing as this did not bring any speed advantage). All other
  556. loading functions were faster on my configuration or were not available
  557. with the standard loaders. A saver module for some formats is also included.
  558.  
  559. Where to find the latest versions
  560. =================================
  561.  
  562. New versions become usually available at least at the following places:
  563.  
  564. 1) FTP and BBSs
  565.  
  566. Aminet sites and mirrors or mirroing BBSs
  567.  
  568. 2) CD-ROMs
  569.  
  570. The most recent versions should be available on the "Actual Tools & Demos"
  571. CD (ADX). This is usually updated every few days (it is a golden CD which
  572. means that there is no long production time).
  573.  
  574. It will also usually be available on Aminet CDs (currently appearing
  575. every two months).
  576.  
  577.  
  578. Version history
  579. ===============
  580.  
  581. 1.0 (14th june 95): Initial release (supporting 21 file formats and DataTypes)
  582. 2.0 (19th june 95): Added menu for picture windows offering Quit, About, SaveAs,
  583.                      Picture Info, Next/Previous Picture, Transfer, Downscale
  584.                     Added fast direct transfer functions to ImageFX, XiPaint
  585.                      and ArtEffect/PicoPainter
  586.                     Added saving functions (7 formats) for picture conversions
  587.                     Added function to go back to previous pictures
  588.                     Added scrollbars for comfortable scrolling
  589.                     Implemented faster scrolling methods
  590.                     Functions like scrolling/resizing now already usable
  591.                      during the next picture is loaded
  592.                     Window position will now be left unchanged for newly
  593.                      opened windows if possible; the scroll position will
  594.                      be left unchanged between pictures of identical size
  595.                     Information requesters for unreadable pictures/problems
  596.                     Preloading is suppressed if not enough memory is available
  597.                     Support of downscaled loading (1:1, 2:1, 4:1, 8:1)
  598. 3.0 (30th june 95): New reduced color output function which is available with
  599.                      OS3.0 and not only with OS3.1. This makes CyberShow usable
  600.                      for all OS3.0 users now (drawing speed is increased for
  601.                      standard Amiga screens and some WB emulation screens as well).
  602.                     Support of separate screen with screenmode specified in
  603.                      ENV:CyberShowScreen
  604.                     Added menu function to select a new directory and/or pattern
  605.                     Slightly changed CLI parameter extraction for more compatibility
  606.                      with non-standard shells/utilities
  607.                     Changed menu colors for OS3.x look
  608.                     Changed file requester for saving to a save requester with
  609.                      picture file name as default for save name as well
  610. 3.1 (7th july 95):  Support of use of named foreign public screen with name
  611.                      specified (with a leading *) in ENV:CyberShowScreen
  612.                     Information requester if screenmode or public screen can't be
  613.                      found or own screen can't be opened
  614.                     Fixed bug which could lead to crashes if files couldn't be opened
  615.                      after they have been stored in the internal list; now you can
  616.                      choose to try the next picture or quit the program in case of
  617.                      any difficulties during opening/loading
  618.                     Fixed bug which could lead to problems if window couldn't be opened
  619.                     Correction of Sun raster 24Bit loading (wrong colors and
  620.                      problems with odd sized images)
  621. 3.2 (21st july 95): Support for RLE compressed 8Bit and 1Bit BMP files
  622.             Bug fix for loading function which could lead to crashes if
  623.              certain non-picture files where detected as a picture
  624. 3.3 (24th july 95): Enhanced CLI parameter control incl. multiple picture arguments
  625.               and new parameters (e.g. to suppress subdirectory search etc.)
  626.                     Added Workbench parameter support for pictures and even drawers
  627.             Added muliple-file-selection support for file/path requester
  628.             Extended information window (now incl. file size, file comment)
  629.             Now ignoring icons (.info files) on default
  630.             Next/previous picture now also selectable with space/backspace keys
  631. 3.4 (27th july 95): Now configurable by Tooltypes for start from WB
  632.             Introduction of "DefaultPath" Tooltype to specify a directory
  633.                      as default for the file requester by WB start
  634.             New option "Request" for automatic requesting of new
  635.              path/pattern/files after displaying is finished
  636.             Introduction of Progress indicator which appears in the
  637.              window title if Next/Previous picture is selected before
  638.              the picture is available (preloaded)
  639.             Higher file requester window for easier multi-selection
  640. 4.0 (1st aug. 95):  Introduction of SlideShow and Presentation window features:
  641.              in standard mode window will now be resized instead of
  642.              being closed and opened again if picture size changes;
  643.              in presentation mode window size will be unchanged unless
  644.              changed by the user; in slideshow mode a borderless
  645.              (optional: backdrop) displaying will be used for pure
  646.              presentations, esp. on private screens
  647.             Introduction of transition effects for SlideShows or
  648.              presentation mode
  649.             Changed min. window size and set useful small alternate
  650.              window size on default for zoom gadget
  651.             Introduction of IgnoreError option to skip unreadable
  652.              files quietly (useful if you e.g. have many non-picture
  653.              files like .readmes on a CD you want to scan for pictures
  654.              without getting lots of errors)
  655. 4.0a (2nd aug. 95): Bug fixes for window titles (could lead to corrupt titles)
  656. 4.1 (5th aug. 95): Changed TIF loader for better compatibility with certain pics
  657.            Extended Targa loader by 15Bit and 16Bit HiColor loading
  658. 4.1a (7th aug. 95): Corrected XiPaint transfer problems (appeared in V3.3)
  659. 4.2 (15th aug. 95): Added 5 new transition effects for slideshow/presentations
  660.             Changed window redraw for scrolling/resizing to be done
  661.              without effects in presentation windows
  662. 4.3 (20th aug. 95): Introduction of automatic advancing to next picture (delay
  663.              option) after specified number of seconds
  664.             Introduction of loop mode (for endless presentations)
  665.             Screen font changed to other font instead system text font
  666. 5.0 (30th aug. 95): Introduction of fast zooming functions for magnified or
  667.              reduced viewing (1:4 upto 4:1)
  668.             Support for new file formats: binary-EPS bitmaps (RGB,CMYK)
  669.              and TBCPlus frames
  670.             Fixed lockup-bug which occured if picture had to be reloaded
  671.              for new downscaling factor but was not accessible anymore
  672.             Added (partial) german documentation file
  673.  
  674. Special Thanks
  675. ==============
  676.  
  677. My special thanks go to:
  678.  
  679.  Kermit Woodall from NOVA-Design for providing me with ImageFX-EGS and ImageFX.
  680.  Thomas Dorn for providing me with XiPaint.
  681.  Almathera for providing me with Photogenics.
  682.  Alexander Pratsch for providing me with ArtEffect (successor of PicoPainter).
  683.  Without this support the fast direct transfer functions or loader modules
  684.   would probably have been impossible.
  685.  Thomas Sontowski and Frank Mariak for making the TrueColor/HighColor
  686.   Workbench possible.
  687.  The "Independent JPEG Group" for providing the portable C source code
  688.   for JPeg compression/decompression. The JPeg functions are based on
  689.   this code (This software is based in part on the work of the independent
  690.   JPeg Group).
  691.  and to all registered users of CyberShow, esp. thoose who reported bugs
  692.   or made suggestions...
  693.  
  694. Hard- and Software used for developing
  695. ======================================
  696.  
  697. This program is written in pure Assembler (using the german assembler
  698. O.M.A. 2.0). Only the lowlevel JPeg functions have been implemented
  699. in C (based on the portable C source of the Independent JPeg Group)
  700. and compiled with the german MaxonC++ 3.0 system.
  701.  
  702. My development system is:
  703.  
  704. Amiga 3000/030/25MHz / 18 Megabytes RAM / OS3.1 (incl. OS3.1 CD file system)
  705.  
  706. 4MByte Piccolo SD64 (64Bit) graphics board (running in Zorro III-mode).
  707.  
  708. This program was tested with enforcer and mungwall running.
  709.  
  710. Disclaimer
  711. ==========
  712.  
  713. This software (program and documentation) is provided "as is" and
  714. comes with no warranty, either expressed or implied.
  715. The author is in no way responsible for any damage or loss that may
  716. occur due to direct or indirect usage of this software. You use
  717. this software entirely at your own risk.
  718.  
  719. Copyright
  720. =========
  721.  
  722. This software (program and documentation) is copyright by
  723.  
  724.                         Helmut Hoffmann
  725.             Rubensstrasse 4
  726.             D-41063 Mönchengladbach
  727.  
  728.             Germany
  729.  
  730. The demo version may be freely distributed and used as
  731. long as the following conditions are met:
  732.  
  733. 1) All files have to be kept together
  734.  
  735. 2) No file may be modified or crunched/packed.
  736.  
  737.    The only official way to distribute this demo packed is the
  738.    original .lha archive.
  739.  
  740.    The program may not be disassembled or analysed. The limitations
  741.    integrated in the demo version may under no circumstance be removed
  742.    or bypassed.
  743.  
  744. 3) Distributors may only charge for the duplication process (including media)
  745.    and not for the software. Theese charges may not exceed the following
  746.    limits: a) Demo on a PD-disk: 8$ (US-dollar) including
  747.               postage&packing (in Germany: 12DM)
  748.        b) Demo on a PD-CD-ROM: 50$ (US-dollar) including
  749.               postage&packing (in Germany: 75DM)
  750.        c) Demo on a BBS/Mailbox/ftp-site or other electronically
  751.               callable system: Maximum charge 4$ (US-dollar) (in Germany: 6DM)
  752.               for downloading
  753.    Anyway, it must be made explictly clear to the buyer, that he does not
  754.    pay for the program (demo) itself but only for the duplication service.
  755.  
  756. 4) It is not allowed to distribute the demo with any commercial product
  757.    without a written permission by me. One exception is the distribution of
  758.    the demo version with products not exceeding the above price limits (e.g.
  759.    a cover-disk magazine for 8$ or less).
  760.  
  761.    The following companies have my explicit permission to distribute the
  762.    demo with their products: NOVA Design, Ingenieurbüro Helfrich.
  763.  
  764.    If you want to distribute the demo with your commercial product
  765.    (hardware or software) write to me for details.
  766.  
  767. 5) The registered version (the keyfile) may not be redistributed. It may only
  768.    run on one machine per registration. It is allowed to make a backup copy
  769.    of the original disk.
  770.  
  771.